home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / BARNET / FREENET / AEBY / SMAILRM- / README < prev   
Text File  |  1995-07-02  |  5KB  |  143 lines
  1. This is the module release of smail.
  2.  
  3. The only significant change to the release from 29.5.1995 is that
  4. smail now runs as a module. This basically means that when you start
  5. smail the module is loaded, then executes your command and then dies
  6. again (you can install the module residently by executing the command
  7. smail -bp -oBresident). The basic advantage is that multiple copies
  8. of smail can run concurrently without each time loading the whole
  9. program (time/disk) and with code sharing (memory).
  10.  
  11. I still miss comments on this port of smail ...
  12. If I won't get any I'll abort development.
  13.  
  14. 1. Installing
  15.  
  16.   1. Copy the usr directory to $.usr
  17.   
  18.   2. Edit $.usr.smail.lib.config (only visible_name and hostnames absolutely
  19.      need to be changed) and
  20.      $.usr.smail.lib.routers (change "path=" of the smarthost
  21.      driver to the FQDN of your mail server)
  22.      
  23.   3. edit etc.passwd (replace user1 by the name of you)
  24.      you can add new users by using !NewsBase's menus
  25.   
  26.   4. add the "Newsbase.smtp" directory to !NewsBase transports
  27.      (Not really tested but should work)
  28.      
  29.   5. run !boot
  30.   
  31.   6. copy bin.smailrm and bin.runqwrap into a directory contained
  32.      in your run$path
  33.      
  34.   6. you can now run !run (or do something different - I suggest
  35.      you have a look at the !boot file to see what functions
  36.      smail provide - I just say "aliases")
  37.      
  38.  
  39. 2. Installing if you have already got uucp/smail installed
  40.  
  41.   1. replace !uucp.bin.smail by bin.smailrm
  42.   
  43.   2. add the host, addr out of usr.smail.lib.routers entries to
  44.      /usr/smail/lib/routers (either $.usr.smail.routers or
  45.      !uucp.usr.smail.routers), replace the smarthost entry
  46.      
  47.   3. add the smtp entry to /usr/smail/lib/transports
  48.   
  49.   4. copy the "set alias..." commands out of the !boot file
  50.      into !uucp.!boot (don't forget to run !boot after).
  51.      
  52.   ... should be all ...
  53.      
  54.   5. re-run !uucp_conf if you want to remove SMTP support
  55.  
  56.  
  57. 3. Functionality:
  58.  
  59. !run: runs smail in daemon mode (-bd) as a wimp task (-oW), listen
  60.       to the smtp port for incoming connections and run through
  61.       the spooled mail queue every 5 minutes (-q5m)
  62.       
  63.       Whenever an incoming connection is detected in_smtpd is run
  64.       on the specific port (yep, another wimp task using about 448k)
  65.       
  66.       When the queue re-run time is reached runq is run (yet another
  67.       wimp task using about 1Meg!)
  68.       
  69.       Memory requirements: 320k + 1Meq when running through the queue
  70.                          + 448k for every open incoming connection
  71.                          
  72. smtpd: read smtp commands from the keyboard (stdin resp.) and output
  73.        responses to the screen (stdout resp.)
  74.        
  75. runq: start up a wimp task running through the mail queue and trying
  76.       to send the spooled messages
  77.       
  78. rsmtp: run batchsmtp mode - take smtp commands from stdin
  79.  
  80. in_smtpd: run a smtpd daemon for an incoming connection. This command
  81.       is executed by "!run" for every incoming connection. Please don't
  82.       run this command manually.
  83.       Received messages will only be stored in the mail queue rather
  84.       than being directly delivered. This is preferable if you run
  85.       an "expensive" connection to the outer world (e.g. SLIP over
  86.       modem) as this will be much faster than delivering immediately.
  87.       Messages will be delivered on the next runq run.
  88.       
  89. mailq: list the messages queued for delivery
  90.  
  91. rmail: read a message from stdin and deliver to the addresses given
  92.        on the command line (e.g. "rmail test@anywhere.com")
  93.        
  94.        
  95.  
  96. 4. Known Bugs
  97.  
  98. Many of them ... a selection:
  99.  
  100.    1. no MX (DNS) support ("bind" router driver)
  101.    2. sometimes crashes when memory is low
  102.    4. smail has mostly been tested with ACORN's TCP/IP suite -
  103.       I don't know if it'll work with freenet correctly.
  104.       
  105. Send bug reports to aeby@graeff.com, please!
  106.  
  107.  
  108.  
  109. 5. Further documentation
  110.  
  111. Get the UUCP documentation from hensa (the man pages are too large
  112. to include them here). It includes the smail documentation.
  113.  
  114. To add:
  115.    There are some RISC OS specific options:
  116.   
  117.       -oW[name]        (e.g. smail -bd -oWsmail_daemon)
  118.                   run smail as a wimp task (if possible - if 
  119.                   wimp_init fails fall back into CLI command mode).
  120.                   Use name (optional) as the name appearing in
  121.                   the Task display.
  122.                   The wimp task can only be quit in the
  123.                   Task display (or if the program quits by itself)
  124.                   
  125.       -ssocketnumber    (e.g. smail -bd -s10)
  126.                   This option does only make sense together with the
  127.                   -bd option and does then mean:
  128.                   Run smail in daemon mode serving one open connection
  129.                   on the open socket "socketnumber". This option is
  130.                   used by in_smtpd
  131.                   
  132.       -oBname        rmkill the module "name" on exit.
  133.       
  134.                   
  135. Thomas Aeby,
  136. 2.7.95
  137.  
  138. Send comments to aeby@graeff.com, please
  139.  
  140.       
  141.   
  142.   
  143.